dopus request <text> <buttons>

This command allows you to request a choice from the user.

 text  is a string of text to be displayed in the requester.

 buttons  are the buttons you wish the requester to have; each button
should be separated by a vertical bar character ("|").

For example,
 + dopus request '"Please choose an option" Option 1|Option 2|Option 3'

Note the quotes around the entire argument string. 

You can have multiple lines in the requester text by putting the "return"
character at the end of lines. 

This would display a requester with the string "Please choose an option",
and three buttons labelled "Option 1", "Option 2" and "Option 3".

The cardinal number of the selected button is returned in  RC . The last
button supplied ("Option 3" in this case) is designated a Cancel button,
and so returns the value 0. Therefore, the values returned by this example
are 1, 2 and 0 respectively.

See also:

 dopus getstring 
 lister request 
 lister getstring